home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / libcompress-bzip2-perl / README < prev   
Text File  |  2005-08-09  |  3KB  |  89 lines
  1.  
  2. Compress::Bzip2
  3.  
  4. Version 2.09
  5.  
  6. 9 Aug 2005
  7.  
  8. The subdirectory bzlib-src contains almost all of the files from the
  9. 1.0.2 distribution of bzip2.  What's missing is that I only included
  10. the html flavour of the documentation.  See the README in there for
  11. more information.
  12.  
  13. DESCRIPTION
  14. ===========
  15.  
  16. This module provides a Perl interface to the bzip2 compression algorithms.
  17. It uses the low level interface to the algorithm, and reimplements all
  18. high level routines.
  19.  
  20. What is Bzip2 ?
  21. ===============
  22. Bzip2 is a portable lossless data compression library written in ANSI C.
  23. It offers pretty fast compression and fast decompression.
  24. Bzip2 has very good results, if you want to compress ASCII Documents.
  25.  
  26. Bzip2 is probably not great for streaming compression.  It fills it's
  27. internal buffer, which depending of parameters is between 100k and 900k
  28. in size, before it outputs ANY compressed data.  It works best compressing
  29. an entire document.
  30.  
  31. Streaming decompression on the other hand, gives a steady torrent of bytes.
  32.  
  33. What is Perl-Bzip2 ?
  34. ====================
  35. Perl-Bzip2 provides Bzip2 bindings for Perl5. I.e. you can access the
  36. Bzip2 library from your Perl scripts thereby compressing ordinary
  37. Perl files, streams, whatever.
  38.  
  39. It's my intent to make this package like the Compress::Zlib package, so
  40. that code that uses one can fairly easily use the other.  The perlxs stuff
  41. that's visible to perl has methods that have the same names as their
  42. Compress::Zlib counterparts, except that the "g" is changed to a "b".
  43.  
  44. Most code that uses Compress::Zlib should be able to use this package.
  45. Simply change
  46.  
  47.    $gz = Compress::Zlib::gzopen( "filename", "w" );
  48.  
  49. to
  50.  
  51.    $gz = Compress::Bzip2::gzopen( "filename", "w" );
  52.  
  53. I made aliases of all the Compress::Zlib functions.  Some of them don't
  54. return anything useful, like crc32 or adler32, cause bzip2 doesn't
  55. do that sort of thing.  Take a look at t/070-gzcomp.t and t/071-gzuncomp.t.
  56.  
  57. Bug fixes and other feedback are welcome.
  58.  
  59. Copyright
  60. =========
  61. bzip2
  62. Julian Seward, j s e w a r d   a t   a c m . o r g
  63.  
  64. Compress-Bzip2 is distributed under the terms of the
  65. GNU General Public License (GPL).  See the file COPYING.
  66.  
  67. Many Thanks to:
  68. ===============
  69.  
  70. Author of bzip2:
  71. Julian Seward, j s e w a r d   a t   a c m . o r g
  72. Cambridge, UK
  73. http://sources.redhat.com/bzip2
  74.  
  75. Author of Compress::Zlib:
  76. Paul Marquess, p m q s   a t   c p a n . o r g
  77. http://www.cpan.org
  78.  
  79. Author of 1.x Compress::Bzip2 (1999)
  80. Gawdi Azem <azemgi@rupert.informatik.uni-stuttgart.de>
  81. (last known email, no longer valid)
  82.  
  83. Sisyphus, helped out with win32 compatibility
  84. s i s y p h u s 1   a t   o p t u s n e t . c o m . a u
  85.  
  86. Marco "Kiko" Carnut, author of Compress::Bzip2 1.03
  87. k i k o   a t   t e m p e s t . c o m . b r
  88.  
  89.